Gigma

Контентные блоки

Блоки позволяют менять отдельные части интерфейса без выпуска новой версии frontend: баннер, текст, изображение, ссылку или группу дочерних элементов.

Каждый запрос ограничен текущим Application. Для интеграции предпочтителен человекочитаемый identifier: он стабильнее внутреннего числового code и понятнее в коде продукта.

Получение блока по code

Метод
GET
URL
https://api.gigma.ru/api/counterparty/blocks/{code}
Авторизация
App Token
Headers
Token: {application_token}
Успешный ответ
200

Пример запроса

GET /api/counterparty/blocks/9 HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Accept: application/json

Ответ

{
    "block": {
        "id": 42,
        "code": 9,
        "identifier": "home-hero",
        "name": "Главный баннер",
        "avatar": null,
        "block_type": {
            "id": 3,
            "name": "Картинка"
        },
        "link": "/catalog",
        "file": null,
        "text": "Новая коллекция",
        "parent": null,
        "children": [],
        "created_at": "2026-08-15T10:00:00+00:00"
    }
}

Ошибки

  • 401 — App Token отсутствует или недействителен;
  • 404 — блок с таким code не найден в текущем Application.

Получение блока по identifier

Метод
GET
URL
https://api.gigma.ru/api/counterparty/blocks/id/{identifier}
Авторизация
App Token
Headers
Token: {application_token}
Успешный ответ
200

Пример запроса

GET /api/counterparty/blocks/id/home-hero HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Accept: application/json

Ответ

{
    "block": {
        "id": 42,
        "code": 9,
        "identifier": "home-hero",
        "name": "Главный баннер",
        "avatar": null,
        "block_type": {
            "id": 3,
            "name": "Картинка"
        },
        "link": "/catalog",
        "file": null,
        "text": "Новая коллекция",
        "parent": null,
        "children": [],
        "created_at": "2026-08-15T10:00:00+00:00"
    }
}

Ошибки

  • 401 — App Token отсутствует или недействителен;
  • 404 — блок с таким identifier не найден в текущем Application.

Как читать ответ

  • avatar и file — объекты загруженных файлов или null;
  • block_type определяет назначение блока;
  • parent содержит краткую ссылку на родителя;
  • children содержит вложенные блоки текущего элемента;
  • link и text могут быть null.

Не используйте id или code блока одного приложения в другом: одинаковые значения не означают одинаковый контент.

© 2026 Gigma